home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr20 / vmasc.zip / VMASC.TXT < prev   
Text File  |  1995-01-23  |  10KB  |  222 lines
  1.  
  2.                    VmASC UTILITY -ver 1b
  3.     (C)P. Mihok - VMV Ltd. - 5694-4 Hwy.7 E.,Unit 193,
  4.             Markham, Ontario Canada L3P 1B4
  5.                     Jan 23 1995
  6.  
  7. ---------------------------------------------------------
  8. :DESCRIPTION:
  9.  
  10.    This little utility lets you draw a colour screen of
  11. IBM extended graphic characters with the mouse, to install in
  12. your text mode software for example, or to provide a title
  13. page or other screen for other software. To run it, type
  14. GO-V at the prompt, and the batch file will run, giving a demo.
  15.  
  16. ---------------------------------------------------------
  17. :GENERAL REMARKS:
  18.  
  19.    I wrote it because I was frustrated at not being able to
  20. examine for myself, on the screen, just how a combination of
  21. colours and characters would look, without programming it in
  22. detail in C code, a genuine waste of time; also, it struck me
  23. it would be fun to use, and the results would be useful. Also,
  24. I don't like having ANSI.SYS taking up RAM on my machine so
  25. I didn't want an ANSI drawing package. Besides, it's impossible
  26. to predict whether someone else has ANSI.SYS running, so you
  27. can't distribute the result. I also thought it would be useful
  28. to draw custom screens to add to C programs.
  29.  
  30.   The package, of course, doesn't have all the features of ANSI -
  31. for example, it doesn't have fast or slow blink nor detailed
  32. control of foreground and background blink. It just uses the
  33. basic attributes available in EGA 16 colour character mode.
  34. For the shareware release I'm not distributing the version that
  35. writes to a pure ASCII file and lets you read or rename files
  36. from the software. I'm also considering doing a self executing
  37. file and adding more bells and whistles to the new version.
  38. If you would like that version, send me a little folding green!
  39.  
  40. ---------------------------------------------------------
  41. :TO USE:
  42. ---------------------------------------------------------
  43. :LOADING:
  44.  You can load a file from the command line by typing its name
  45. as follows:
  46.  
  47. VMASC FILENAME.EXT
  48.  
  49. on the command line.
  50.  
  51. It will try to load the file. However, you should only load
  52. character mode screen capture files of 4k in length. The
  53. utility writes files named ASCIIPIX.@V@, so you should type
  54.  
  55. VMASC ASCIIPIX.@V@
  56.  
  57. It will load the last file you saved, (unless you renamed
  58. it.)
  59.  
  60. ---------------------------------------------------------
  61. :RUNNING:
  62.  The software requires a DOS mouse driver to run, so be sure
  63. to have a mouse driver loaded. (It detects if there is no
  64. driver loaded.) It also requires a minimum of EGA to run, but
  65. will run with a CGA or mono monitor. (However, you won't be
  66. able to see the colours on a mono monitor, of course.) I no
  67. longer have a CGA monitor to test things on, so I don't know
  68. how it looks on one, but it works OK on a TTL monitor. (Of
  69. course a VGA and super VGA monitor will work, running in EGA
  70. mode, which happens automatically when you start the software.)
  71.  
  72.  At the first screen (a HELP screen) push the mouse button to
  73. start a screen. (Hitting a key returns you to DOS.) You'll
  74. find the mouse button has different repeat rates depending
  75. on what you are doing, but basically it works slower in menus
  76. and fastest when you are drawing, so you don't leave artifacts
  77. on the screen coming out of a menu. (If you do, you can hit
  78. the DELETE key. If something else is in the last-button memory
  79. and nothing happens, you can press the mouse button with the
  80. mouse cursor atop the unwanted character to show DELETE what
  81. you want to delete!)
  82.  
  83. ---------------------------------------------------------
  84. :MENUS:
  85.  
  86.   There are two function menus and a HELP screen (F1).
  87. ---------------------------------------------------------
  88. :MENU 1:PICK A CHARACTER AND COLOUR:
  89.  
  90.  The first function menu appears when you hit the right mouse
  91. button. It lets you select a character and foreground and
  92. background colour attributes. It redraws every time you pick
  93. a character or colour (with the left mouse button) so you can
  94. see how it will look. When you have the character and colour
  95. you want, hit the right mouse button to exit this menu.
  96.  
  97. ---------------------------------------------------------
  98. :MENU 2:FILL OPERATIONS:
  99.  
  100.  This menu appears when you hit both mouse buttons at the same
  101. time. (This can be a little tricky to get the hang of - I keep
  102. ending up in the character/colour menu, myself.) The selections
  103. let you fill the background, fill or clear the whole screen,
  104. fill upper,lower,right or left halves of the screen, or mark
  105. block areas of the screen to capture and copy, fill, change the
  106. attributes of, or clear. The left mouse button activates and
  107. the right mouse button escapes. There isn't a floating highlight
  108. bar since I thought it would add needless complexity to the code,
  109. but if people want it I can add it.
  110.  
  111.  Fill works only on areas that don't already have something in
  112. them (cleared areas) except block fill, which overwrites. I felt
  113. that it was better to have them each work differently so you
  114. have more flexibility.
  115.  
  116.  The menu contains a Global Character Replace feature which lets
  117. you replace all examples of a selected character, across the screen,
  118. with the current character and attribute. I may have added block
  119. character replace by the time of release.
  120.  
  121.  This menu also has an "UNDO" feature that undoes the last operation
  122. that you performed which left something on the screen. It has only
  123. a one button-deep memory, though.
  124.  
  125. ---------------------------------------------------------
  126. :DRAWING AND WRITING OPERATIONS:
  127.  
  128.   When you are on the main screen, you can press the left mouse
  129. button to paste the character and attribute where you want it.
  130. If you want to delete the last character you pasted, try hitting
  131. the DELETE key. You can put the mouse cursor atop any example of
  132. the current character with attribute which you want to delete, and
  133. press the mouse button then press DELETE. To delete a character to
  134. the background value, hit the white background, the black foreground
  135. and the zeroth character (which looks like a blank, at the upper
  136. Left Hand corner) in the char/colour menu.
  137.  
  138.  You can hit the INSERT key to insert typed text, using the keyboard.
  139. The DOS cursor appears on the screen and can be moved around using
  140. the arrow keys. Text appears where you type it. When you hit the
  141. backspace key, it stores the character it found in the previous
  142. location, in its restore memory, so you can hold the key down to
  143. repeat that character backwards across the screen. You can also
  144. move the cursor somewhere else and hit BACKSPACE to keep on repeating.
  145. When you're done using the text insert mode, hit ESC to return to
  146. the mouse cursor (which is usually still where you left it.) The
  147. text insert mode uses the current colour attributes, chosen from
  148. the first menu. Note this is not a word processor, so it lacks many
  149. edit features. They could be added, but I don't really see any point.
  150.  
  151. ---------------------------------------------------------
  152. :SAVING AND VIEWING:
  153.  
  154.  When you leave (hitting ESC) you will be in an exit screen that
  155. asks if you want to save. Hit Y or y and it will write a file
  156. called ASCIIPIX.@V@. (If there is already a file with that name
  157. it will overwrite it. So, if you want to save previous efforts,
  158. you have to rename them from outside the software. The registered
  159. version lets you rename from inside the software.) 
  160.  
  161.  You can reload this file by typing its name after VMASC on the
  162. command line when starting the software, as previously discussed.
  163. (The registered version gives you a menu to select a file.) It
  164. doesn't check whether you are loading the correct type of file,
  165. so there is no telling what will happen if you fool around with
  166. that! <g>
  167.  
  168.  A utility is also included, VAVIEW, which will load a file called
  169. ASCIIPIX.@V@ if there is one in the current directory, and then
  170. it will display it. (The demo uses it.) VAVIEW has no options,
  171. it merely displays ASCIIPIX.@V@ and nothing else. (I was considering
  172. providing the ability to make a self displaying file out of your
  173. drawings, but will wait and see how many people pay for registration
  174. before I waste my time with that.)
  175.  
  176. ---------------------------------------------------------
  177. :DISCLAIMER:
  178.  
  179.                 - VMV Ltd. assumes no responsibility for the 
  180. consequences of any application of any software product. Although 
  181. all software has been carefully and thoroughly tested before 
  182. release, VMV Ltd. assumes no liability for any software or 
  183. hardware incompatibilities, for loss of data, disc damage, nor for 
  184. any other consequences resulting or claimed to result from the use 
  185. in any manner of their software. Use of the software is entirely 
  186. by the user's choice and at the user's risk. Resale, 
  187. redistribution and copying of this software at cost only, is 
  188. freely permitted, if the shareware package is entirely unaltered.
  189.  
  190. -----------------------------------------------------------
  191.  
  192.  History:
  193. Jan 22 1995 - first beta test release
  194. Jan 23 1995 - first real release, fixed a number of irritating
  195.   little quirks with the way the mouse worked. Added extra button
  196.   memory processing to make DELETE work better. Added global char.
  197.   replace feature. Fixed errors in documentation. Ver 1b.
  198.  
  199.  
  200.  
  201. ---------------------------------------------------------
  202. :REGISTRATION ETC.:
  203.  
  204.   VmASC can be registered for $15, paid by cheque/check or money
  205. order to 
  206.  
  207. VMV LTD. - 5694-4 Hwy 7 E., Unit 193, Markham Ont., Can.,L3P 1B4
  208.  
  209.   Give your E-Mail address so I can post you an upgrade copy.
  210. (Or if necessary I'll use snail mail, 3.5" disc preferred on
  211. my part, but please specify. Give your name and address etc!)
  212.  
  213.   You can reach me by fax, 905-471-5440, or by E-Mail c/o
  214.  
  215.   NEIL 70107,3050@COMPUSERVE.COM
  216.  
  217.   Starting in Feb '95, I will be on Compuserve and will release
  218. an upgrade version with my COMPUSERVE account, so the software
  219. I've been releasing there can be registered online.
  220.  
  221. ---------------------------------------------------------
  222.